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Preface 


This publication is for system administrators and operators of 
CRAY J90 Series systems. It provides the procedures that are 
necessary for installing your CRAY J90 console software and the 
UNICOS operating system. 


Related 

publications 


Because CRAY J90 Series systems run the UNICOS operating 
system, you will find the entire UNICOS manual set to be 
helpful. However, because some differences exist that are 
especially important to system administrators and operators, the 
following Cray Research, Inc. (CRI) publications help you run 
UNICOS successfully on CRAY J90 Series systems: 

• UNICOS Release Overview, publication RO-5000 

• UNICOS Basic Administration Guide for CRAY J90 and 
CRAY EL Series, publication SG— 2416 

• UNICOS User Commands Reference Manual, publication 
SR^2011 

• CRAY lOS-V Commands Reference Manual, publication 
SRr-2170 

• CRAY lOS-V Messages, publication SQ-2172 

• UNICOS Administrator Commands Reference Manual, 
publication SR-2022 

• Software Overview for Users, publication SG—2052 

• UNICOS General System Administration, publication 
SG-2301 
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Conventions This manual uses the following typographical conventions: 

Convention Meaning 

typewriter font Denotes literal items such as command 

names, file names, routines, directory names, 
path names, signals, messages, and 
programming language structures. 

italic font Denotes variable entries and words or 

concepts being defined. 

bold typewriter font 

In screen drawings of interactive sessions, 
denotes literal items entered by the user. 
Output is shown in nonbold t5rpewriter font. 

[ ] Brackets enclose optional parts of a command 

line. 

< > Angle brackets indicate that you must use at 

least one of the enclosed options. 

In this pubUcation, Cray Research, CRI, and Cray refer to Cray 
Research, Inc. and/or its products. To avoid redundancy or 
awkwardness, Cray Research may occasionally be shortened to 
Cray (for example, Cray disk or Cray job). 
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Ordering 

publications 


Reader comments 
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The User Publications Catalog, publication CP-0099, lists all 
Cray Research hardware and software manuals that are 
available to users. 

To order a manual, either call the Distribution Center in 
Mendota Heights, Minnesota, at (612) 681-5907 or send a 
facsimile of your request to fax number (612) 681-5920. Cray 
Research employees may choose to send electronic mail to 
order . desk (UNIX system users) or order desk (HPDesk 
users). 


If you have comments about the technical accuracy, content, or 
organization of this manual, please tell us. You can contact us in 
any of the following ways: 

• Send us electronic mail from a UNICOS or UNIX system, 
using the following UUCP address: 

uiuiet ! Cray ! publications 

• Send us electronic mail from any system connected to Internet, 
using the following Internet addresses: 

pubs5271@timbuk. Cray . com (comments specific to this 

manual) 

publications@timbuk . cray . com (general comments) 

• Contact your Cray Research representative and ask that a 
Software Problem Report (SPR) be filed. Use PUBLICATIONS 
for the group name, PUBS for the command, and NO-LICENSE 
for the release name. 

• Call our Software Information Services department in Eagan, 
Minnesota, through the Technical Support Center, using either 
of the following nvunbers: 

(800) 950-2729 (toll free from the United States and 

Canada) 

(612) 683-5600 
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• Send a facsimile of your comments to the attention of 
“Software Information Services” in Eagan, Minnesota, at fax 
number (612) 683-5599. 

V7e value your comments and will respond to them promptly. 
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Overview [1] 


Introduction 

1.1 


Related 

Information 

1.2 


This document is for system administrators and operators of 
CRAY J90 Series computer systems. It explains the procedures 
for installing the CRAY J90 console software and the UNICOS 
operating system. 


With the introduction of the Sun SPARCstation'^“ as a system 
console on the CRAY J90 series, software installation has 
improved dramatically from other CRAY platforms. You can now 
use the windowing capabilities of the Solaris™ operating system 
on the CRAY J90 console to simplify and streamline the 
installation process. Also, by using the embedded hard drive on 
the console and the connections to the I/O subsystems via a 
private Ethernet, there is a single point of control for system 
installations and upgrades. 

This guide is divided into six sections, each focusing on a specific 
tjT)e of operation you may be performing: 

• Overview of the CRAY J90 system and the software 
installation process 

• Installing CRAY J90 system console software 

• Cray Install Utility general instructions 

• Installing CRAY J90 softwEire 

• Customizing UNICOS 

• J90 UNICOS 9.0.2 Release Information 


Before you begin any of the procedures outlined in this guide, 
you should read through the entire section that relates to the 
procedure you intend to perform. 

You should have the following documentation available: 
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Hardware 

Components 

1.3 


CRAY J90 Console 
1.3.1 


• UNICOS Basic Administration Guide for CRAY J90 and 
CRAY EL Series, publication SG—2416 

• CRAY lOS-V Commands Reference Manual, publication 
SR-2170 

• CRAY lOS-V Messages Reference, publication SQ-2172 

• UNICOS Administrator Commands Reference Manual, 
publication SR-2022 


Note 

Read the Read Me First for CRAY J90 System Installation 
document shipped with your system before proceeding with 
these instructions. 


The minimum hardware configuration of each CRAY J90 series 
system includes a CRAY J90 console, an lOS, and a CRAY J90 
mainframe. 


The CRAY J90 console is Sun SPARCstation’^” workstation 
running the Solaris operating system. This workstation serves 
as the system console for each lOS and the CRAY J90 
mainframe. This console is connected via a private Ethernet 
connection to each lOS. It is shipped with a CD-ROM drive as 
the only media device. It also contains disk space that is used to 
run the Solaris operating system, to store all the necessary lOS 
files, and to run the Cray J90 Install Utility. 
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Figure 1. CRAY J90 console 


Input-Output Subsystem 
(lOS) 

1.3.2 


This diskless I/O Subsystem (shown Figure 2) runs the 
Vxworks™ operating system with CRAY device drivers installed. 
The entire software that runs on the lOS is also referred to as 
lOS-V software. Each lOS is connected to the mainframe via Yl 
channels. The I/O Subsystem is shipped with a Digital Audio 
Tape (DAT) device on IOS-0 serving as the primary media device 
for software installations and backups. 
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I/O Cabinet 


Removable 
Disk Drives 


Peripheral Options 


VME lOS 


Peripheral Drawers 



Front View 


Mainframe Cabinet 


Front-end Power 
Assembly 


Figure 2. CRAY J916 I/O Cabinet and Mainframe Cabinet Components 


If you need to power-cycle the machine, you must press the CPU 
reset button first followed by the VME reset button on the 
control panel. Failure to press the reset buttons in this order 
will cause the power-up diagnostic tests to fail. 


4 


Cray Research, Inc. 


SG-5271 9.0.2 



UNICOS Installation Guide for CRAY J90 Series Systems 


Overview [1] 


CRAY J90 Mainframe 

1.3.3 


Software 

Components 

1.4 


Sun SPARCstation 
Installation Materials 

1.4.1 


CRAYJ90CD 

1.4.2 


J90 UNICOS Release 
Tape 

1.4.3 


The CRAY J90 mainjframe (also shown in Figure 2) runs the 
UNICOS operating system. The allowable backplane t 3 T>es are 
1x1, 2x2, 4x4, and 8x8. There can be up to 8 processor modules 
with each module containing 4 CPUs. There can be up to 8 
memory modules with a combined range of 0.25 to 4 Gbytes. 


CRAY J90 series systems include the components described in 
this subsection. 


Note 

All of the software necessary to run your system will be initially 
installed by Cray Research. Your console, lOSs, and CRAY J90 
mainframe will be a working system when you receive it. 


A Solaris CD contains the Solaris Operating system with on-line 
documentation and installation instructions. This CD will only 
be necessary if you have to reinstall the Solaris operating 
system. 


This CD contains a one-time setup procedure for enabling the 
Sun SPARCstation to serve as a system console to the lOS and 
CRAY J90 mainframe. This includes setting up a console 
enviroiunent that uses a Graphical User Interface (GUI) for all 
subsequent installations (called the J90 Install Utility). The 
intention is to release this CD only once for initial machine 
deliveries. 


The CRAY J90 UNICOS release tape contains all the software 
required to operate the J90 console, the lOSs, and the J90 
mainframe. Included on this tape are five files: 

• lOS tar file 

• Install teir file 
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• Generic UNICOS file system 

• Generic system files 

• UNICOS binaries 
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Solaris Installation 

2.1 


This section describes the steps necessary for installing your 
CRAY J90 console software. 


The Solaris operating system must first be installed on the Sun 
terminal prior to running CRAY J90 installation procedures. 
Please refer to the Solaris installation manuals delivered with 
the Sun SPARCstation. 


Note 

All of your essential software has been installed Cray Research 
prior to the delivery of your CRAY J90 system. The procedures 
in the following section will only be necessary if you have to 
reinstall your CRAY J90 console software. 

Cray Research is not responsible for the use of this console for 
any other purpose than for explicitly operating CRAY J90 
systems. 


To ensure adequate disk space for the CRAY J90 installation, 
allocate all remaining disk space to the /opt file system 
partition. This partition will be used to store the installation 
and lOS-related files. 
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CRAY J 90 Console 

Software 

2.2 


The CRAY J90 console software is initially delivered to you on a 
single CD which is read by the CD-ROM drive on your console 
hardware. Subsequent updates to the CRAY J90 console 
software will be included on J90 UNICOS release tapes. 



CD-ROM 


Figure 3. CRAY J90 console 


lb install the initial CRAY J90 console software, perform the 
following tasks: 

1. Ensure that the Solaris operating system is installed on your 
CRAY J90 console. Refer to the Solaris Basic Installation 
Guide delivered with your Sun SPARCstation. 

You should allocate all disk space not used by the Solaris 
operating system to the /opt file system partition. 

2. Insert the CRAY J90 CD into the CD-ROM drive. 

3. Log in as root and change directories to the mount point for 
the CD-ROM device as follows: 

# cd /cdrom/cdromO 
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lOS-V Man Pages 

2.3 


4. Read in the files fi*om the CD. 

# ./setup 

Enter the serial number of your system when you receive the 
following prompt: 

Please enter J90 serial nximber: xsaac 

This is a one-time only procedure that will perform the 
following tasks: 

• Sets up the crayadm account 

• Sets up the crayadm home environment 

• Sets up the ios group account 

• Loads the opt . tar file from the CD into /opt /install, 
/opt/local, and /opt /packages 

• Establishes the J90 Console script ( j con) script for the 
master IOS 

• Sets up the BOOTPD daemon 

• Updates the following Solaris network files in /etc: 
inetd. conf, services, hostname . lei, netmasks, 
hosts, ns switch . conf 

• Loads the CD-ROM version of the J90 Install Utility 

5. Eject the CD. 

# cd / 

# eject cdrom 

# reboot 

6. Log in with the crayadm account using the password of 
initialO. 


CRAY lOS-V man pages now reside on the Sun SPARCstation. 
You can view them by using the Solaris man(l) command in any 
window (not from the console window at the IOS prompt). 


SG-5271 9.0.2 


Cray Research, Inc. 


9 





Cray Install Utility [3] 


The Cray Install Utility is a graphical user interface used to 
install software on lOS-V I/O subsystems and CRAY 
mainframes. Currently, this utility is only supported on the 
CRAY J90 system. This utility runs in OpenWindows under the 
Solaris operating system on the CRAY J90 console. 

Each CRAY J90 installation screen is designed to be a 
single-focused task in the installation process, consistent and 
easy-to-use. This first section on look-and-feel rules display the 
general windowing rules followed in the Cray Install Utility. The 
next section on window layouts define the CRAY-specific 
implementation of the look-and-feel rules. 


Look and Feel 
Rules 

3.1 


To keep the user interactions simple, only single left-button 
mouse clicks are required for selections and actions. The only 
exceptions are when left-click and drag is required and pull 
down menus. The following section describes the general 
windowing look-and-feel rules utilized in the CRAY J90 
Installation Utility windows. 
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• Action buttons 


These are raised rectangular boxes that initiate an action 
when selected. 



• Radio buttons 

These are raised rectangular boxes with a preceding triangle. 
Clicking a radio button causes it to be exclusively selected 
among all the buttons in its group. A selected radio button is 
displayed in dark red. 






vMWMItisteBatlim 




V HantwafB Upgrade 
V/ Mscelanemtt : 


• Checkboxes 

These are raised rectangular boxes with a preceding square. 
Clicking a check button toggles the button selection state. 
Multiple check boxes may be selected in a group. A selected 
checkbutton is displayed in dark red. 
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• Listboxes 


These are used to display a multiple selections that span more 
than one window. You can scan the list either by using the 
scrollbar clicking or by dragging list box. To select an 
individual item in the list box, simply click on the selection. 

• Entry labels 


These are sunken rectangular boxes used to enter text by 
pointing, clicking, and typing. You can delete by selecting and 
typing Control -d. Backspace, Control -h, and Delete 
may be typed to erase the character just before the insertion 
point. Control -W erases the word just before the insertion 
point, and Control -u clears the entry. For entries that are 
too large to fit the window all at once, you can scan through 
the entries by dragging with mouse button 2 pressed. 
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• Scales 

A slide bar and horizontal scales are used to select and display 
values. Simply click and drag the scale to your requested 
value. 

• Dialog boxes 

These are used to convey information in a separate window. 
Common uses of dialog boxes are to include an OK action 
button to continue processing after the message has been read. 
Other uses are to display ongoing information of a currently 
running process. 
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Window Layout 

3.2 


• Pull-down menus 

These are used to display multiple selections that are kept 
hidden behind a single character (V) to prevent cluttering the 
display. To make a change selection, position the cimsor on the 
pull-down character (V) and hold the right mouse button. 


Each CRAY J90 Installation Utility window is designed to be 
processed top-down from the user’s perspective. A title at the 
top of each window clearly identifies the action to be taken. 
Each screen is designed to display user-input fields first, 
followed by action buttons displayed at the bottom. CRAY J90 
Installation Utility windows employ the following features: 

• Status line 

The second line of each window is a status line that displays 
useful informational and error messages. 

• Help button 

The Help button is displayed in the upper right-hand comer 
on the status line. Context-sensitive help and a full display 
documents are available by selecting this button. 
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• Quit 

The CRAY J90 Install Main Window is the only window 
containing a Quit button (located next the Help button in the 
upper right hand comer). Selecting this option is the only 
way to exit the CRAY J90 Install Utility. 
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• Cancel 

With the exception of OK dialog boxes, each screen has a 
Cancel action button. This allows you to safely return to the 
calling window. 



• Speedometers 

When a selected action takes a significant period of time to 
complete, a speedometer window is displayed to indicate the 
on-going status of that process. These windows display a 
STOP action button to halt processing. If STOP is chosen, an 
updated Speedometer screen is displayed with allowable 
actions of Resume, Restart, and Cancel. Completion of 
processes with Speedometer windows display a completion 
dialog box. 
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• Error Displays 

Errors are displayed in a separate dialog box. These errors 
are context-sensitive to the action selected. When appropriate, 
a suggestion is offered for assistance. 

• Input Validation 

Wherever possible, user validation is performed at the time of 
selection. This reduces the frustration of encountering errors 
when an action button is selected. 

• Screen Locking 

When a sub-window is invoked, the focus of that window is 
selected to prevent the user from selecting other Cray J90 
Install Utility actions. This ensures single-focused processing 
to eliminate confusion. 
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This section describes procedures for installing and upgrading 
CRAY J90 lOS and UNICOS software. Before proceeding, 
ensure you are logged into your CRAY J90 console with your 
crayadm account. 

Log files are used throughout the J90 Install Utility and are 
located in the / opt / ins t al 1 / log /xxxx directory. Viewing 
these files with standard editors, like vi, cannot handle the long 
line lengths making output appear incomplete. To properly view 
these log files, you should use the following command: 

# £old -80 logfile | more 

Please note the J90 Install Utility requires running in Secure-X 
mode. Certain X Window System Utilities, (like xhost +), can 
disable the Secure-X mode. If any of the J90 Install Utility 
programs detect Secure-X mode is disabled, the installer will be 
instructed to completely log off the Sun SPARCstation and log 
back in again under the crayadm account. This procedure will 
re-establish the Secure-X mode. 

The J90 Installation Main Window is invoked by holding the 
right button in the Open Windows root window and selecting the 
J90 Install Menu item. 



This selection displays a window labeled J90 Install Main 
Window. The allowable radio-button selections are defined in 
the following sections. 
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Initial Software 
Installation 

4.1 
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This section describes the procedures to perform an initial 
UNICOS and lOS software installation, or to perform a 
reinstallation of your current UNICOS and lOS software. Initial 
installations are performed at the factory prior to shipping. 
Please note that these procedures may destroy any preinstalled 
CRAY J90 Series system software. 

If you ciirrently have UNICOS running, perform a system 
shutdown by entering the following command from the system 
console: 

icoNTROL-in (toggles to the UNICOS prompt) 

# /etc /shutdown 

Then, select Initial Installation from the J90 Install Main 
Window. 
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I/O Subsystem Setup 
4.1.1 


The following menu appears: 





\ SSfiS H«ni|g 


XT I/O Stimystafii Setup | 

Lo&d htsteB EfWirofUTiefit } 



Meinfreme llawtware Setup f 

X/' Mttai instaiRraon ( 



Return to Halii Menu 
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The first step in your software installation is to set up your I/O 
subsystem. Selecting J/0 Subsystem Setup allows you to define 
the Ethernet board addresses and the IP hardware addresses for 
each lOS. This is required to initiate communication activity 
between the CRAY J90 console and each lOS. 

Selecting this menu displays a Select Mainframe window with 
actions of Add, Change, Delete, or Cancel. 



After entries are validated, the action updates the appropriate 
Solaris system files on the console disk. 
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I/O Subsystem Add 
4.1.1.1 


Selecting the Add action-button allows you to define a 
mainframe with Ethernet and IP addresses for up to 16 lOS’s. 
Perform this action to define a new mainframe and associated 
lOS’s. 


'U '■/" ^ i/OSotoystw # Mi ^-1 

! Ml 

Mainframe Send number |90i( 

i lOS Ethemt IP Address 

Ml 1 1 

Ml 1 

Ml 1 

5 3 j 1 

1 '1 

i s 1 ! 

Ml 1 ! 

Mi j 

s * ! 1 I 

Ml 1 i 

i “ i 1 i 

S » 1 f : i 

I “ 1 I i 

. ^ 1 1 , 

( W 1 1 

! u j j j 

Add 1 CANCEL ( 


The Ethernet board addresses are printed on the Themis board. 
The IP Addresses are automatically generated based on 
mainframe serial number once the Ethernet address is entered. 


20 


Cray Research, Inc. 


SG-5271 9.0.2 




UNICOS Installation Guide for CRAY J90 Series Systerns 


CRAY J90 Installation [4] 


I/O Subsystem Change 
4.1.1.2 


Selecting the Change action-button allows you to add, change, or 
remove Ethernet and IP addresses for specific lOS’s on a 
mainfi*ame. 


^ IJ )9SI/aSybsysttmChft«9» 


1 Mainframe Serial number 9001 

; lOS Ethernet IP Address 
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The Ethernet board addresses are printed on the Themis board. 
The IP Addresses are automatically generated based on 
mainframe serial number once the Ethernet address is entered. 
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I/O Subsystem Delete 
4.1.1.3 


Selecting the Delete action-button allows you to delete an entire 
mainframe definition of Ethernet and IP addresses. 



Mainframe Serial mimber 9061 

lOS Syieniet IP Address 

a 00^d>a^:b4;40 U.UJ0 


1 

z 
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6 
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10 
11 
12 

13 

14 

15 

Detete j CAHCEL 


When the Delete action-button is selected, the following dialog 
box appears: 






The following ¥ramings were detected: 

Thediiecto^/optAos/9200e9^ I/O «ibsystem(s) root directoiy for 

mainframe seriid numto* ”9200'’. Removing this directoiy will remove all I/O 
subsystem software. 

nresf the Remove button to remove the root directoiy /optAos/9200. 

Press the Do Not Remove button to not remove the root directoiy /opt/ios/9200 
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If you select the Remove action-button, you must manually 
perform the following command from an Open Windows window 
logged on as root: 

# unahara /opt/loa/xxxx (xxxj^ = Serial number of machine 


Load Install 

Environment 

4.1.2 


The Load Install Environment procedure updates the CRAY J90 
installation binaries on the console from the J90 UNICOS 
release DAT tape. Upon completion, additional menu items that 
were previously graved out from the CRAY J90 CD-ROM 
installation will be loaded and enabled. 

If you are performing an initial install starting from CD-ROM, 
after running the Load Binaries procedure, you must quit the 
J90 Install Utility and restart it before continuing the 
installation. This avoids an lOS reset problem between the 
CD-ROM version of Load Binaries and the J90 UNICOS 9.0.2 
version 

Selecting the Load Install Environment menu item from the 
Initial Software Installation window displays a Select 
Mainframe window with action-buttons of Load Binaries and 
Cancel. 



Selecting the Load Binaries action-button will display the 
following dialog box: 
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Mainframe Hardware 

Setup 

4.1.3 


Selecting the OK action-button initiates the loading of the 
installation binaries from tape to the J90 Console. A Load 
Binaries Speedometer is displayed to keep you informed of the 
progress of the load. 


pBBH 

1 tsumaiec 


Time Remaining {in nMnutee) [4 | 

IBil . : , 1.,^ J 


Upon completion, the following message is displayed. 



Completed loading install binaries from tape. To 
activate the J90 Install changes, you must quit the J90 
Install Utility and restart it before continuing the 
installation. 


Press the OK button to return to the main install 
window 



lb activate the J90 Install changes, you must quit the J90 
Install Utility and restart it before continuing the installation. 
Failure to do so will result in errors with new routines. 


The Mainframe Hardware Setup procedure is required at initial 
machine setup and each time a processor module or memory 
module is replaced. This procedure creates the configuration 
files containing the ASICS chip information that are required to 
clear the lOS prior to running UNICOS on the CRAY J90 
mainframe. These files are accessed on the lOS and are in the 
following format; 

/ sys /pmO . c f g # Processor Module configuration 

/sys /memo . cf g # Memory Module Configuration 


Selecting the Mainframe Hardware Setup menu item from the 
Initial Software Installation window displays a window with 
action-buttons of Setup Hardware and Cancel. 
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Selecting the Setup Hardware action-button displays the 
following menu to query for information about the processor and 
memory modules: 









Serial isimber 9001 
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1 ConfiSUTB Harsiware 


CANCEL p 


• The Backplane Type must be selected. Allowable entries are 
1x1, 2x2, 4x4, and 8x8. 

• The Number of Processor Modules must then be selected. 
Optionally, you may also speciiy the bit mask for each 
processor module to turn off selected CPUs on the Processor 
Module. A pull-down menu is provided displaying all possible 
settings. 

• Select the appropriate number of Memory Modules and the 
Memory Type of each module. The memory type is stamped on 
each memory module board. A pull-down menu is provided 
displaying all possible settings. 
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Upon entry into the Mainframe Hardware Setup window, the 
display for the Memory Type may be incorrect. If this occurs, 
simply re-enter the correct Memory Type via the pull-down 
menu before selecting the Configure Hardware button. 

Selecting the Configure Hardware action-button will display the 
followiricr dialog box: 


The following warning! were d^ected: 

The hardware fettip procecx ^ take the syrton to PROM. Re«e ensure that the 
system is nmiung in single user mode and has been properly sync'd up. Failure to 
do so miqrcause a system crfoh and or data corruption 

; Ress die Continue button to ignore warnings and continue with the hardware 
1 setup. 

Press the Cancel button to return to the "J90 Mainfoame Hardware 
i Configuration” window 

; Owitlnue I Cancal | 


Selecting the Continue action-button verifies the specify files on 
the lOS and, if necessary, loads them from the UNICOS release 
tape. The procedure then performs a quick-load on the lOS, and 
runs the jconf ig command on the lOS. If the jconf ig 
command is successful, the processor module and memory 
module configuration files will be created. If the j conf ig is 
unsuccessful, you will be instructed to run the jconf ig 
command manually from the lOS console. 

A speedometer window is displayed to keep you informed of its 
progress: 


Sati^wiira Setup Spaedomatst* 
Estimated Tbtm Remaining (in mltuites) 
Percentage Completed 



Stop 




Cancel 


Upon completion, the following dialog box will be displayed: 



26 


Cray Research, Inc. 


SG-5271 9.0.2 





UNICOS Installation Guide for CRAY J90 Series Systems 


CRAY J90 Installation [4] 


Initial Installation 
4.1.4 


Selecting the Initial Installation menu item from the Initial 
Software Installation menu displays a Select Mainframe window 
with action-buttons of Quick Install and Cancel (the Custom 
option is not available yet). 



After selecting a mainframe, clicking the Quick Install 
action-button displays a J90 Quick Install window with six 
panels of information described below: 
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• Hardware Information 

Default settings for the System Name and System Node are 
filled in. You may change these values by clicking in the 
entry-label-box and editing them. 

SaritlNiintarSOTII 
SytliTO Itoroi 



• Memory 

The number of memory boards are selected based on the 
probing by the jconf ig command (performed in the 
Mainframe Hardware Setup procedure). If this setting is 
incorrect, you will need to run the Mainframe Hardware Setup 
procedure. If you wish to run UNICOS with less memory than 
selected, you may decrease the memory setting specified. 


Memmy 

Memory Soarils 4 

Memory y 32mw 
^ S4mw 



• Processor Modules 

The number of Processor Module boards are selected based on 
the probing by the j conf ig command (performed in the 
Mainframe Hardware Setup procedure). If this setting is 
incorrect, you will need to run the Mainframe Hardware Setup 
procedure. If you wish to run UNICOS with fewer CPUs than 
selected, you may decrease the setting specified. 
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• Load Optional Async Product Relocatables 

With the release of UNICOS 9.0, all optional asynchronous 
relocatables are automatically loaded. Therefore, this panel of 
input can be ignored. 


Load Ofttkatd Agmc ftoduaKdbcatabki 

IHliiliili 

IBiilBi BliiM IllJHilli 

ill 
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• Disk Information 

If you wish to have the system parameter file automatically 
generated, select the generate new radio-button. For CRAY 
J90 Series systems, there is a significant change to the disk 
space allocation scheme compared to the CRAY EL Series 
systems. If this option is specified, two sets of production disk 
partitions are created (named roota/usra/srca and 
rootb/usrb/srcb). This allows for a subsequent upgrade 
installations into the alternate set of partitions in multiuser 
mode without disturbing the running system. In addition, the 
bkroot and bkusr disk partitions are automatically created 
for you. The bkroot and bkusr file systems should be used 
for backing up your cvurent production system. The only 
exception to this is CRAY J90 machines with extremely 
limited disk space. Specifically, any space beyond 1465536 4K 
b 3 Tte blocks will be allocated to the following file systems: opt, 
bkroot, bkusr, home, diskO - diskxx. 

Starting with UNICOS 9.0, an /opt partition is created for 
as 5 mchronous product installations when the generate new 
option is selected. This new file system is built with a size of 
150,000 4K-b3d« blocks. 

If you plan to use an existing parameter file, select the use 
existing radio-button and you will be prompted for the desired 
file in an entry-label box. When the Start Install action-button 
is later selected, the rootdev statement in the selected param 
file will be validated against the root partition and will display 
an warning dialog-box if they differ. 
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DycMormatitm 

PwamFH* 


• Partition Selection 

If you wish to select alternate partitions for loading 
root/usr/src, click in the desired entry-label and edit. If 
you selected the generate new option, a /sys/param file is 
built for you using roota and rootb. 


Partition Selection 


Selecting the Start Install action-button from the J90 Quick 
Install menu displays the following dialog box: 

^ Massage' y -- ' 

j Please ensure the J90 UNICOS rdeas« tape is 
j insmed into the tape drive. Piess the OK 
I button to continue with this procedure. 


Selecting the OK action-button initiates the installation and 
displays a speedometer window to keep you informed of its 
progress. 




Estimated Time Reniaiiung (in minutes) 


LoadlMbos 


I iGnmel Build | Cost. 


A log file window will then be displayed in the upper right-hand 
comer capturing the detailed output of the installation. 

If you have pressed the Stop action button to interrupt the 
software installation, three additional action buttons are 
highlighted: 
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Post Initial Install 

Procedures 

4.1.5 

password 

4.1.5.1 


• Resume 

Selecting Resume restarts the software installation from the 
last checkpointed process (/OS, Load UNICOS, Kernel Build, 
or Customization). 

• Restart 

Selecting /?cstort completely restarts the software installation. 

• Cancel 

Selecting Cancel returns you to the J90 Initial Installation 
menu. 


Estimated Time Remaining (in minutes) |ro 

fl wn cw iliBg 



Stop 


LoadUrdcos 


Sarittl Build j Cost. 


Upon completion, the following completion dialog-box will be 
displayed: 


The quick install has completed for 
serial number "9001*'. Press the OK 
button to reUum to the Initial Install 
window 

__ __ _ 


Perform the following procedures after you have completed your 
initial software installation. 


The root password is initial, which you should change using 
the passwdd) command. For details about the passwdd) 
command, see the UNICOS User Commands Reference Manual, 
publication SR-2011. 
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core partition 
4.1.5.2 


ICMS Tbol 
4.1.5.3 


Initial Installation 
Procedures Complete 
4.1.5.4 


Software Upgrade 
Installation 

4.2 


Pre-upgrade procedures 
4.2.1 


State of the system 
4.2.1.1 


The J90 Install procedures do not automatically create (itikf s) 
the /core partition or initialize the dvunp partition (via 
mkdump). This should be done before entering multiuser mode. 
For more information, refer to the UNICOS Basic 
Administration Guide for the CRAY J90 and CRAY EL Series, 
publication SG-2416. 


If you want to run the Installation and Configuration 
Managment System (ICMS), you must first BVIPORT ALL 
parameters, l^fer to section 6.3.1 for more information. Failure 
to perform this procedure prior to an ACTIVATE, will cause 
customized parameters to be overwritten by generic values from 
the release tape. 


The procedures for reinstalling CRAY J90 UNICOS are now 
complete. Refer to Section 6, J90 UNICOS 9.0.2 Release, for 
general release information and known problems. 

For more information on administering your system, refer to the 
UNICOS Basic Administration Guide for CRAY J90 and CRAY 
EL Series, publication SG-2416, and/or UNICOS General System 
Administration, publication SG-2301. 


This section describes the procedures for sites that are currently 
running CRAY J90 Series system software and are upgrading to 
a new release level. 

Please note that for CRAY J90 Series systems, there are no 
procedural differences between installing a UNICOS revision 
and a UNICOS update. 


This subsection describes what you need to do to prepare for 
your upgrade. 


Before starting the Upgrade installation, you must ensure the 
system is in the following state: 

• UNICOS is in multiuser mode 


32 


Cray Research, Inc. 


SG-5271 9.0.2 




UNICOS Installation Guide for CRAY J90 Series Systems 


CRAY J90 Installation [4] 


File system allocation 
4.2.1.2 


Disk space requirements 
4.2.1.3 


• The J90 Console is logged into UNICOS as root 

• The UNICOS root prompt must end in one of the following 
characters; % or # or $ 

• The J90 Console window has been released (- . ^c) 


For CRAY J90 Series systems, there is a significant change to 
the disk space allocation scheme compared to the CRAY EL 
Series systems. At initial installation, two sets of production 
disk partitions are created (named roota/usra/srca and 
rootb/usrb/srcb). This allows for an upgrade installation 
into the alternate set of partitions in multiuser mode without 
disturbing the running system. The J90 Install Utility is 
designed to perform upgrade installations into the alternate set 
of partitions (although the installer can specify other partitions 
if desired). 


The minimum recommended disk space partitions allocation for 
J90 UNICOS 9.0.2 are as follows (4K byte blocks): 

root = 110,000 

usr = 190,000 

src = 120,000 


Usage of the src partition is decreasing since many 
asynchronous products are installing into the /opt partition (i.e. 
Programming Environment 2.0). Since many sites support 
existing asynchronous products, we have not changed our 
recommendation for the src partition from UNICOS 8.0. Each 
site should ensure enough space is allocated for existing 
asynchronous products. 

For additional information on file system size information 
regarding P.E. 2.0, please refer to Installing Programming 
Environment Products 2.0, publication SG— 5191. 

Please note on J90 and EL UNICOS initial installations, the 
/opt partition is automatically created for you with a size of 
150,000 4-Kbyte blocks. 

If you need to modify your disk configuration, refer to the 
UNICOS Basic Administration Guide for CRAY J90 and CRAY 
EL Series, pubhcation SG-2416. 
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MLS sites 
4.2.1.4 


Software Upgrade 
4.2.2 


Upgrade Install 

Environment 

4.2.2.1 


The J90 Upgrade Installation process requires the icoNTROL-i1 
(^a) console featxxre enabled during multiuser mode. Therefore, 
MLS sites that have disabled the feature will have to 
temporarily enable it during the upgrade process. 


Select Software Upgrade from the J90 Install Main Window: 




Helpl Qult| 


iiiiii 


iB: 

j 



j 



j 


The following menu appears; 

. <r«>cv» 



V l^qrade ktslall Envirnimatt 

J 


V Upgrade tnstallafion 

J 


Retun to Main Menu 





The Upgrade Install Environment should be performed each 
time a new J90 UNICOS release is installed. This procedure 
updates the CRAY J90 installation binaries on the console from 
the UNICOS release DAT tape. 
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Note 

If you are performing an upgrade from J90 UNICOS 
8.0.3.2 J or 8.0.3.2K, running the Load Binaries step in the 
Upgrade Installation window will cause the lOS to reset 
to the BOOT prom causing a running UNICOS system to 
crash. To avoid this problem, follow the procedures in 
section 6.2.10 to manually load the binaries. Upon 
completion of this step, proceed to the Upgrade 
Installation subsection. 


Selecting this menu item displays a Select Mainframe window 
with action-buttons of Load Binaries and Cancel. 



Selecting the Load Binaries action-button displays the following 
dialog box: 


Please ensure the J90 UNICOS release tape is 
insetted into the tape drive. Ftess the OK 
Intmn to continue with this procedure. 




OK 


Selecting the OK action-button initiates the loading of the 
installation binaries iBrom tape to the J90 Console. A Load 
Binaries Speedometer is displayed to keep you informed of the 
progress of the load. 
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Upgrade installation 
4.2.2.2 


Upon completion, the following message will be displayed. 



Completed loading install binaries h-om tape. To 
activate the J90 Instdl changes, you must quit the J90 
Install Utility and restart it b^ore continuing the 
instaliauGn. 

Press the OK button to return to the main install 
window 

OK 


Selecting Upgrade Installation from the Software Upgrade menu 
displays a Select Mainframe window with action-buttons of 
Upgrade Install and Cancel. 



Note 

There is a problem with tape device access for this procedure. 
Please check section 6.2.1 before continuing. 


After selecting a mainframe, click the Upgrade Install 
action-button to display a. J90 Upgrade Install window with six 
panels of information described as follows: 
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• Hardware Information 

Default settings for the System Name and System Node are 
filled in. You may change these values by clicking in the 
entry-label-box and editing them. 


Hardware Monnation 

Swisi NuiaieraOTD 

System Itsds jtnS070 
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• Memory 

The number of memory boards are selected based on the 
probing by the jconf ig command (performed in the 
Mainframe Hardware Setup procedure). If this setting is 
incorrect, you will need to run the Mainframe Hardware Setup 
proced’-^^e from the Initial Software Installaiion menu. If you 
wish to run UNICOS with less memory than selected, you may 
decrease the memory setting specified. 


Bliliiliil MwBwy 

Muniii^ iiiwnii# 

Memciy y Sitm | 


• Processor Modules 

The number of Processor Module boards are selected based on 
the probing by the j conf ig command (performed in the 
Mainframe Hardware Setup procedure). If this setting is 
incorrect, you will need to run the Mainframe Hardware Setup 
procedure from the Initial Software Installation menu . If you 
wish to run UNICOS with fewer CPUs than selected, you may 
decrease the setting specified. 


C3PU 

f^DCSssoT Mochites I 
tliMiiwr^ifCPys 

4 


• Load Optional Async Product Relocatables 

With the release of UNICOS 9.0, all optional asynchronous 
relocatables are automatically loaded. Therefore, this panel of 
input can be ignored. 
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Load Optibnai AQttcl^rodactRdocat^^^ 

- matrix - 

' rT#»l>afliaoii 

lilliiilil ilW 

iiiiiliBil B III 


• Disk Information 

You must enter the name of the param file of the currently 
running UNICOS system. This will be used to determine the 
available partition selection for the next panel of information. 


Disk Information 

Param File 

Curentpaam Itej/^ys/pansyn 


• New Partition Layout 

The J90 UNICOS Upgrade procedures are designed to install 
into an alternate set of partitions (i.e. not on into the running 
partitions like it was on the Cray EL Series machines). 

This panel displays the new partition layout desired for the 
upgrade installation. If the rootdev statement is something 
other than roota or rootb, you will need to specify the raw 
partition that the upgrade process will utilize. 

If the rootdev statement on your current param file specified 
either roota or rootb, the New Partition Layout window will 
be filled in with the alternate set of partitions to install into. 

The set of partitions you are installing into must be at least as 
large as the partitions you are currently running. 

The preserve flags are used by the upgrade process to allow the 
user to specify whether or not to retain the current file systems 
you are installing into. When this flag is set to n, the raw 
(logical) partition will be mkfs’d and fsck’d, labeled, mounted, 
and restored from the current system (if this is a 9.0 jc to 9.0.y 
upgrade). When the flag is set to y, only f sck and moiint will 
be performed on the raw partition. 
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Selecting the Start Upgrade action-button from the J90 Upgrade 
menu will display the following the following dialog box; 



Selecting the OK action-button initiates the installation and 
displays a speedometer window to keep you informed of its 
progress. 


&timat£dtke1lenaitmigCffliaimtes} piT' 



A log file window will then be displayed in the upper right-hand 
comer capturing the detailed output of the installation. 

If you have pressed the Stop action button to interrupt the 
software installation, three additional action buttons are 
highlighted: 

• Resume 

Selecting me restarts the software installation from the 
last checkpointed process (Load UNICOS, Customization, 
Kernel Build, or lOS). 
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• Restart 

Selecting Restart completely restarts the software upgrade 
installation. 

• Cancel 

Selecting Cancel returns you to the Software Upgrade menu. 


Note 

Please note that selecting the Stop action-button during the 
dump/restore portion of the LOAD Unicos phase, followed by the 
user opening the J90 console, may cause the J90 Console to 
appear hung. If this occurs, wait for a few minutes for the 
dump/restore process to gracefully shutdown. The system 
console will return to the UNICOS prompt. 


Estimated Time Ranaining (in minutes) jii" 

i 

CM i&mglBdldj lOS 
Restart | (Mel 



Upon completion, the following dialog-box will be displayed: 


Softwares tlpgwMle Contplotign 


The software upgrade has completed for 
sa-ial number "9001". Use 
”/bin/boot.902" script to boot the 
upgraded sfystem. Press the OK button to 
return to the Software Upgrade window 




Post Upgrade 

Procedures 

4.2.3 


This subsection describes what you need to do before you have 
booted the upgraded system. 
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Initialization files 
4.2.3.1 


UNICOS 8.0 to 9.0 upgrade 
4.2.3.1.1 


UNICOS 9.0 to 9.0 upgrade 
4.2.3.1.2 


holiday file 
4.2.3.1.3 


There are different requirements for customizing initialization 
files with different upgrade paths. 

Because some significant changes may have taken place between 

8.0 and 9.0 configuration files, the 9.0 configuration files are 
installed into /mnt. Many of the configuration files will be 
converted automatically from 8.0 into 9.0, but there are some 
files which may have been locally modified and aren’t converted, 
lb assist in putting local changes back into the configuration 
files, the running configuration files are placed in /mnt / . OLD. A 
dif f(l) is performed between those files, and the files on yoxir 

9.0 system in /mnt, and the output is placed in 
/mnt/ . OLD/f ile_dif f erences. Look over this file to 
determine if any of the old changes need to be incorporated into 
the new files. 

Also, note that the UNICOS 8.0 to 9.0 upgrade process does not 
do a dump and restore of your running system. If you have 
some local files which need to be transferred over to 
/mnt, you should do that now. 

If you are performing an upgrade from UNICOS 9.0, you should 
be aware the J90 upgrade process never updates the /etc/brc, 
/etc/bcheckrc, /etc/rc /etc/nschedv. day and 
/etc/nschedv.nite files, due to the local customization of 
initialization scripts. There may be fixes, however, that are 
applied to these files that may be important to your site. 

Instead of appl3dng these default configuration files to your site, 
they are extracted into /mnt/ .NEW A dif f(l) is performed 
between those files, and the files on your running 9.0 system, 
and the output is placed in /mnt / .NEW/file_diff erences. 
Look over this file to determine if any of the new files need to be 
applied. 

For upgrade installations from UNICOS 8.0 to 9.0, the 
/mnt/usr/lib/acct/holidays file is not automatically 
converted. To run accounting successfully, you will need to 
manually merge the released version of 
/mnt/usr/lib/acct/holidays with yom* site’s 8.0 
configuration files in /usr/lib/acct/holidays. 

You can run the dif f(l) command to see the new additional 
parameters you may need to add to your local configuration file. 
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nfsstart file 
4.2.3.1.4 


Updating production 

filesystems 

4.2.3.2 


Booting the upgraded 

system 

4.2.3.3 


If you are performing an upgrade from J90 UNICOS 8.0 and 
have locally altered the /etc/nf sstart file, you will need to 
restore these modifications. The format of NFS ID mapping files 
(created by nf smerge(8) and used by nf saddmap(8)) has 
changed from UNICOS 8.0 to 9.0. The standard upgrade 
procedure provides a mechanism to update these map files. This 
occurs the first time the UNICOS 9.0 system goes to multiuser 
mode, and is accomplished through the /etc/nf sstart script 
(see nf sstart(8)). That script describes the upgrade details. If 
your site has altered the UNICOS 8.0 /etc/nf sstart script 
(for example, to call local versions of scripts that merge and add 
ID maps), the same changes must be applied to the UNICOS 9.0 
version of the /etc/nf sstart file. 

Therefore, if you are performing an upgrade from J90 UNICOS 
8.0 and have locally altered the /etc/nf sstart file, edit the 
/mnt /etc /nfsstart file to include your local UNICOS 8.0 
modifications. 


If the production system contains a filesystem mounted under 
/usr (for example, the filesystem /usr/adm), then this 
filesystem will not be changed by the J90 upgrade installation 
utility. If the upgrade affects any files in such a filesystem (for 
example, /usr/adm/unn/unnconf ig), then the new version of 
the affected files will be placed in the alternate /usr filesystem 
during the upgrade (i.e. /mnt/usr/adm/urm/urmconf ig). The 
production /usr/adm filesystem that is currently being run on 
will not be automatically changed by the upgrade. 

If you have filesystems mounted under the /usr production 
filesystem, you should check the contents of the alternate 
/mnt /usr filesystem afi;er the install has been completed (before 
booting on the alternate filesystems) to determine if there are 
any new files from the upgrade that need to be manually copied 
back into your production filesystem. For example, if you have 
the filesystem /usr/adm mounted in your production system, 
look in the directory /mnt /usr/adm after the install utility has 
completed. Any files in /mnt/usr /adm will have to be manually 
copied back into their respective locations in /usr/adm. 


Before booting the upgraded system, you must first shutdown 
the running UNICOS, reload the lOS, then run the new boot 
script as described in the J90 Software Upgrade Completion 
dialog box. 
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Optional products 
4.2.S.4 


Crash command 
4.2.3.5 


ICMS Tbol 
4.2.3.6 


Upgrade procedures 

complete 

4.2.4 


Hardware 

Upgrade 

4.3 


If you have configured any synchronous or asynchronous 
products, be sure to rehnk and/or reinstall these products once 
the upgrade is complete. Refer to the appropriate users guide 
for more information regarding configuring and rebuilding these 
products. 


The crash command now resides on the Sun SPARCstation 
offering greater flexibility when analyzing system dumps. If you 
are upgrading fi*om a pre-J90 UNICOS 8.0.4.2 system, please 
remove the lOS V-based crash command by entering the 
following command fi*om the J90 UNICOS Console: 

# snxxxx-iosO> rm /bin/crash 


If you want to run the Installation and Configuration 
Managment System (ICMS), you must first IMPORT ALL 
parameters. Refer to section 6.3.1 for more information. Failure 
to perform this procedure prior to an ACTIVATE, will cause 
customized parameters to be overwritten by generic values from 
the release tape. 


The procedures for the J90 UNICOS upgrade installation are 
now complete. For more information on administering your 
system, refer to the CRAY EL Series Basic Administration 
Guide, publication SG-2416, and/or UNICOS General System 
Administration, publication SG-2301. Please refer to Section 6, 
J90 UNICOS 9.0.2 Release, for general release information and 
known problems. 


lb receive information on where to obtain the latest hardware 
upgrade information, select any of the hardware upgrade 
buttons to display the following dialog box: 







. Mmmmy ypflnwto ■■ :;V . 




I/O Cofitroaer Upara<l» 1 


^ Memory MlPPl Upgrade i 


nelum to Main Menu 
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Note: All five buttons produce the same dialog box. 



Cray Rssearch J90 Sartes Systems have various upgrade q3tkms avaiabifi lo su|^)ort an 
vqnnilrig customer For of these options, Upgrade 

dooinentsarB «vaWe to support the instalation and confIguratiQn changes needed 
to perform the upgrade. These docurrants are avaHabie to the Cray Research Service 
provider via any of the foiowing methods: 


OOIE logon to the Cray Technical Hetworic system host named liydra% Use the 
On line Documentation Interface tool hy foBowIng these steps: 


Enter *datamiaytmyfodte/bin/o(Se* * 
Select •CBAYJSir 

Select *'JS18orJ932 System Information' 
Set«:t "Upgrade Rocedures* 

Select Upgrade Rocedure 


Contact cm8ne@pandora if this autommsit 

pomtls not configurod for your server. 


must have the "ghostview” viewing toolin your path fet order to view 
f^tScript documents. If you do not have a copy of "^lostview* on your 
ser^, contact yotr system adsrdEdstrator. can use the Mosaic 
command "Opliims load to Local Oisic" to download the PostScript 
to aiir^t^Hy of your choice inslead of viewing the lie with 
"ghostview*. Use Mosaic hy follciwlig these st@|^: 


Start Mosaic on a (^Technftrallletwirfc server 
Open the fc^wfng USU 
http://wwwcfxray4:iMn/F^IVAT&HPTIi^ 

Seloit "OIAY Seim U^a^ PTOceihtis (RisIScr^l) * 
Select Ja^^icU^r^ Proc^dyro 


POstscf^t logon to 11^ Criy TicMcii Netwifk system iM^lria^ Ohlafei 

acqiy of the PestScrIpifonnat that corni^icmds lo the upgrade 
type which wi tm Inslai^/ ITie lies are 


ihome%dra/tataiogipostscr|»tf(irna^ 


where dhname is cpu, man, disk, etc. and IKe^is is the 
actual PostScript fie such as 916cpu4» or SlCmem^is. 


E-mel The (>ay R8S^rch Service provIdercanE-maB the request 

documeritation to ordhtt@p^^ 
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Miscellaneous 

4.4 


The miscellaneous options are Thpe Validation, Backup Console 
Environment, and Restore Console Environment. 



V Software Upgrade | 

V Hanhwre Upgrade f 







■ e-:Tape\«(iatlon^: 


v' Bs^kup Consote Bivtonmefit | 


Restore Console Environment | 


Return to Main Menu 

1 


Tape Validation This automated feature will be available in a future release of 

4.4.1 CRAY J90 UNICOS. In the interim, we have provided manual 

steps to verify the release tape. 

The following procedure takes about 20 minutes to complete and 
can be accomplished while the system is running in multi-user 
mode. Insert the tape labeled J90 UNICOS 9.0.2 into your tape 
device and enter the following commands from the J90 Console: 


snxxx-iosO> cd / 
snxxx-iosO> mt -f rpd03 rewind 

snxxx-iosO> tar -xvf rpd03 ./install/scripts. tar . /Install/escripts 
snxxx-iosO> icoNTROL-al iRETURMi (toggles to the UNICOS console) 

# exdf -i install/escripts | /bin/sh 

# /scripts/verify_tape 
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Backup Console 

Environment 

4.4.2 


After some basic prompts, each file on the release tape will then 
be validated and reported on. If the tape does not pass 
verification, please contact the Customer Support Call Center 
(CSCC) at (612) 683-5600 or at the toll-fi*ee number 
800-960-2729 (800-950-CRAY). 

This verification script is also available on CRTs hydra 
computer system via the getfix package verify_tape .902. 


The Backup Console Environment action should be performed 
after each Initial Installation, Software Upgrade, or Hardware 
Upgrade. This procedure backs up the Solaris files related to the 
CRAY J90 installation process and the lOS system software. 


Note 

There is a problem with tape device access for this procedure. 
Please check section 6.2.1 before continuing. 



Selecting this menu item displays a Select Mainframe window 
with action-buttons of Backup Console and Cancel. Selecting 
Backup Console will then display a dialog window informing you 
about the backup to be performed and to insert a DAT tape in 
the lOS before continuing. 






H«lp| 


This procedure backs up the Solaris files related to the 
J90 Install process. Thk inchides files fmm the ^pt file 
system partition as teell as iqidated Solaris system files. 

Insert a OAT ti^ lit the los before contiisaliig. 


Backup Console Environment 


CANCEL 
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Restore Console 

Environment 

4.4.3 


This procedure backs up the following Solaris files related to the 
CRAY J90 installation process: 


• /etc files; 

ethers 
inetd. Gonf 
shadow 
bootptab 
dfs 


hosts 
passwd 
hostname. leO 
hosts . eguiv 
hosts 


services 

ethers 

hostname. lei 
nsswitch. conf 


• / opt files 

home install 

ios packages 

• /usr/sbin/bootpd 


Selecting the Backup Console Environment action-button 
initiates the backup and displays a speedometer window to keep 
you informed of its progress: 



Eackup Cofisote Speedometer 

Estimated Titne Remaining (In minutes) |To 


Parcentage Completeil 

pH 

stop 



Upon completion, the following dialog box will be displayed: 


Completed Backing Up Console Environment 

IVest the OK button to return to the main install 
window 

~~~ " : -OKI 


The Restore Console Environment action should be performed 
only if has been determined the CRAY J90 Console Environment 
has been corrupted and/or you want to revert to the last saved 
Backup Console Environment DAT tape. This procedure 
overwrites files fi'om the /opt file system partition as well as 
Solaris system files. 
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Note 

There is a problem with tape device access for this procedure. 
Please check section 6.2.1 before continuing. 



Selecting this menu item displays a Select Mainframe window 
with action-buttons of Restore Console and Cancel. Selecting 
Restore Console will then display a dialog window to inform you 
about the restoration to be performed and to tell you to insert 
the Console Backup DAT tape in the lOS before continuing. 



This procedure restores the following Solaris files related to the 
CRAY J90 installation process: 


• /etc files: 

ethers 
inetd. conf 
shadow 
bootptab 
df s 


hosts 
passwd 
hostname . leO 
hosts . equiv 
hosts 


services 

group 

ethers 

hostname . lei 
nsswi tch . conf 


• /opt files 

home install 

ios packages 

• /usr/sbin/bootpd 
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Selecting the Restore Console Environment action-button 
initiates the restore and displays a speedometer window to keep 
you informed of its progress: 



Upon completion, the following dialog box will be displayed: 


Completed Restoring Console Environment 


Press the OK button to return to themain install 
window 

ok! 
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Disk 

reconfiguration 

5.1 


This section describes the procedures for customizing your 
installed CRAY J90 Series system software. These procedures 
assume the following: 

• UNICOS is in single-user mode with no file systems mounted 

• The current boot script is /bin/boot 

• The current param file is /sys /param 

• The current root partition is /dev/dsk/roota 

• The current usr partition is /dev/dsk/usra 

• The current src partition is /dev/dsk/srca 

• You will need to adjust the names in the procedures below to 
match your particular site. 


Td change your system’s disk configuration, perform the 
following procedure: 

1. Make a back-up copy of your current param file by entering 
the following commands: 

# IcoNTROL-J (toggles to the lOS console) 
snxxx-iosO> cp /sys/param /sys /param. bak 

2. Transfer the / sys /param file from the lOS to UNICOS by 
entering the following commands: 

snxxx-iosO> icontrol-sI (toggles back to the 

UNICOS console) 

# exdf -i sys/param > new_param 
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3. Edit the /new_param file by entering the following 
commands: 

# /etc/fsck /dev/dsk/roota 

# /etc/£sck /dev/dsk/usra 

# /etc /mount /dev/dsk/usra /usr 

# TESM-vtersti escort TSEM 

# vi /new_param 

For additional information on disk configuration, refer to the 
CRAY EL and J90 Series Basic Administration Guide, 
publication SG-2416. You can also use the Model E 
configuration specification language (CSL) information in 
subsection 3.2 of the UNICOS System Administration, 
publication SG-2113. 

4. Check the configuration file for errors by entering the 
following command: 

# /etc/econ£ig new_param 

5. If no errors are found, update the /dev/mkdev . sh script and 
write the sys /param file back to the lOS disk by entering 
the following commands: 

# /atc/econ£ig -d new_param > /dev/mkdev. sh 

# chmod 700 /dev/mkdev. sh 

# exd£ -ro sys /param < new_param 

6. Reload and boot using the new configuration by entering the 
following commands: 

# /etc/umountem 

# sync 

# sync 

# sync 

# icoNTROL-a1 (toggles back to the lOS console) 
snxxxx-iosO> boot 

7. Create the device entries by entering the following 
commands: 

# cd /dev 

# rm -f dsk/* Idd/* mdd/* pdd/* add/* 

# /dev/mkdev. sh 
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8. Use the mkf s(8) and f sck(8) commands to check new file 
systems and to recreate file systems that have changed size 
due to the new configuration. For initial installations, failure 
to mkfs the /dev/dsk/home file system will cause an error 
when going to multiuser mode. 

9. Backing up the file system is recommended after a change to 
the disk configuration. 


Modifying and 
relinking the 
kernel 

5.2 


lb change kernel configuration file and relink the UNICOS 
kernel, perform the following procedures: 

1. Check and mount the disk partitions by entering the 
following commands: 

# /etc/fsck /dev/dsk/roota 

# /etc/fsck /dev/dsk/usra 

# /etc/fsck /dev/dsk/srca 

# /etc /mount /dev/dsk/usra /usr 

# /etc/mo\ant /dev/dsk/srca /usr/src 

2. Ensure the following files are in the /usr/src/uts/cf . SN 
directory: sn . h, conf . h, and conf ig . h. If these files do not 
exist, recreate them by entering the following commands: 

# mkdir /usr/src/uts/cf .SN 

# cd /usr/src/uts/cf .SN 

# cp /usr/src/uts/cl/sys/sn.9001 sn.h 

# cp /usr/src/uts/cl/cf /conf .c conf.c 

# cp /usr/src/uts/cl/cf /conflg.h config.h 

3. Edit the following kernel configuration files to customize to 
your particular site (SN is your system’s serial number): 

# TERM*xterm; export TERM 

# vi /etc/config/conf ig.mh 

You can edit CONFIG_ID, CONFIG_SN, C0NFIG_SYS, and 
CONFIG_NODE for appropriate values. You can also 
enable/disable features such as tapes or security. Comments me 
provided in the file for more specific information on the setting of 
various parameters. 

# vi /usr/src/uts/cf .SN/ sn.h 
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This file contains values for system serial number, number of 
CPUs, and the size of memory. 

# vl /usr/src/uts/cf .SN/con£lg.h 

This file contains kernel parameters used in the kernel relink 
process. 

4. Relink the kernel by entering the following commands: 

# cd /usr/src/uts 

# rm -r cf.SN/llb/* .o 

# rm -£ c£.SN/Nmake£ile* 

# /usr/bln/ninake rmexe 

# /usr/bln/nmaka install 

5. Save the old kernel, move the new kernel to the lOS disk, 
and unmount the file systems by entering the following 
commands; 

# icoNTROL-a] (toggles back to the lOS console) 

snxxxx-iosO> mv /sys/unlcos .ynqp /sys/unicos .old 

snxxxx-iosO> icoNTROL-a1 (toggles back to the 

UNICOS console) 

# cd /usr/src/uts/c£.SN 

# exd£ -ro sys/unicos.yinp < unices 

# cd / 

# /etc/tmountem 

# sync 

# sync 

# sync 

# icoNTROL-a1 (toggles back to the lOS console) 

6. Reboot the system by entering the following command: 
snxxxx-iosO> boot (boots UNICOS to single-user mode) 
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This section replaces the traditional errata that has. been shipped with previ- 
ous releases, In addition to reading this document, please rerer to the current 
Software Field Notices (located on CRI’s CRInform or on CRJ’s hydra com- 
puter system in Magan, MN) for impcrtant, late-breaking information con- 
cerning" this release. 


Note that for J90 UNICOS, all revisions and updates are cumulative within 
the maior .“elease level and contain ail fixes arid features of prior revisions 
and updates. Therefore, all probleins idendSe-d in this decument as f xed in 
a previous revision or update are also fixed in this update. 


I'V'-a..:': dves far the orobiems Iis' 
i.drs:-! i'.'-r.rictr die Custcntier Supper 
' .^| mimbei 


my SPR YOU open agamst this level of 
poke releases cf J90' LWCCS 9 C vvi:; 
■3 below. Fcf aiditicri.3l tnfomiatioru 
Caii Zentei iCSCCi a' :nT2) clV'nfO 
19 


f'dii' : icucn 
icaif 5of:wai 


iovides upgrade and co'mp'aiibility iiiforination and lists sigrtif- 
or dr. cumeoMicn praHems that are- outstanding ir I've 'riNJ- 
e fbUeiwiag sabsectiens are pfesented:. 


Release Info^rmatlon 

SigrafiruM Open Ptofc.emG 

• 6.3 Problems with Related Products 

• 6.4 J90SPRS Fixed 

• 6.5 J9Q SFNs Fixed 
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6.1 Release Information 

6.1.1 Support of EL/J90 specific character special interface has been dropped at UNI- 
COS 9.0. The interface and drivers will continue to be supplied in UNICOS 9.0 to 
allow sites to convert to the tape daemon character special interface 
(/dev/tape/xxxx) or the normal tape daemon interface (tpmnt). Please note at 
UNICOS 9.2, only the tape daemon and tape daemon character special interfaces 
will be available. 


6.1.2 Physical Disk Device Naming - for CRAY J90 Series systems, there is a signifi- 
cant change to the physical disk device naming scheme compared to the CRAY 
EL Series systenos. The iopath is an octal number used both internally in UNI- 
COS and in several commands and the /sys/param file to describe a disk. The for- 
mat of the iopath is iieeeccc where i = ios, e = eiop, and c = channel. Because the 
eiop and ios numbers are referred to in decimal in the /sys/param file, you will 
need to convert the octal values for these identifiers into decimal values to make 
them correlate to your /sys/param file. 

For example; 00036024 would indicate ios 0, eiop 30 (decimal), and channel 024. 

Commands that use iopath include pddstat and pddconf. TheyTl provide informa- 
tion per disk and "name" the disk using the iopath. Please note these commands 
don’t print leading zeroes, so for the above example (00036024) they would print 
"36024" as the name of the disk. 


6. 1 .3 TCP Channel Numbers on J932 Systems Only 

Following an upgrade or initial installation, the J90 UNICOS 9.0.2 parameter file 
(/sys/param), will contain a line similar to the following, which declares the TCP 
pseudo channel value: 

channel 0112 is lowspeed to pseudo TCP; 

Use of the UNICOS Installation/Configuration Menu System (ICMS) may change 
this channel value to 78 (0116). Either value is correct. 

However on J932 systems, care must be taken to ensure that the Pseudo TCP 
channel does NOT share a channel physically in use by a Y1 or Memory HiPPI. 
This is not an issue for J916 systems (as long as either 01 12 or 01 16 are chosen). 

The following rules for choosing a TCP pseudo channel on J932 systems must be 
satisfied: 

• An EVEN number that is not being used by an actual physical channel (Y1 
or memory HiPPI) 

• The LARGEST value that is less than or equal to 78 (0116) AND greater 
than or equal to 16 (020) 

The ICMS currently does not support altering this param file value; therefore it 
must be changed manually. For affected J932 sites, the param file should be 
checked each time a new version of the file is generated by ICMS. 
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6.1 4 . The tnethod of setting up the arguments file for the mfdump conmandi for the 
CRAY J90 differs significantly from the CRAY EL. The mfdump arguments file 
defines the location of the dump device and identifies the UNICOS areas to be 
dumped. For the CRAY EL,, this binary file, (/sys/mfdump.arg), had to be modi- 
fied from within the mfdump command itself with the ”-q" option. For the CRAY 
J90, this ascii file, (/sys./mfdumpa,arg), can be directly modified with the text edi- 
tor available on the SPARC system console, Therefore, the "-q" option is no 
longer supported in the mfduinp command on CRAY J90 systems. 


6. 1 .5 Documentation 

For the LT^COS 9.0 release, there is still an IdprccofS) man page that specifically 
supports CRAY EL and CR.4Y J90 systems. The ld.proto(8) man page that specif- 
icdly supports CRAY EL and CRAY J90 systems is provided in online form only 
for the J9C UNICOS 9,0 release; a printed man page is not provided,. If you view 
the IdprotofS) man page, make sure you look at the second, displayed man page 
marked for CRAY EL Systems and not the man page marked for Ail Systems. 




.acne 


Since the release J90 UNICOS 8.0. 4B, scalar cache is supported and enabled by 
default. This feature was disabled in the initial software release for the CRAY J90 
dos to possible dalti c-ormption. miscalcaJafions, and/or ORE aborts,. The foliow- 

11 'formslicc iicscr.bfs ue 
affected by eniabling scaiiar cache. 


the problem as wslJ as what other area,s ar; 


nx to fbe scalar cache prGblenn. is in the fcliawmg areas: 






nil( ij commurd 

'i’hjs ccrrintand, when, ran .igaiESt ;ai;i e,»:ecutabie, 
Jbat :.reate a pLobbru '„v>hen ran o-iilt scalai t 
roTrLTCM::! V "b chiange ‘he cods so tnisl the sec. 
a cvoblert 71ie scani(ii: cctiTonaiid mac 


will look for code .seqt.ercfs 
ache enabled. The scanitfl'i 
ceccc of inSiinactioat. do m: 
he ased oto cdier vendor sap- 


pjied prrjgrsms if, and. crdy If, agreements with, Otose vendors penrat the orcv 
grairiiE. to be miodi.ii,ed by the customer. 


This code also sets a bit in the executable’s header that lets the UNICOS ker- 
nel know that the code has been filtered by scantt(l). 


*' segidr(l) 

The segldr command in 190 LWCOS 9.0 will have the same module inte- 
grated into it as is used by the scardtO) command. This module will be run 
when the user’s code is linked and the target platform is a CRAY J90 system. 


• kernel portion 

The kernel portion of the fix will query* the bit in the executable’s header to 
see if scalar cache can be utilized for the program. If it is set, the,n the kernel 
code will attempt to use scalar cache, with some escepiions. 


The kernel utilizes a bit in the exchange package to tom oa^off scalar cache 
in the hardware. When the kernel sets this bit, scalar cache is enabled for the 
process. When this bit is clear, scalar cache is disabled. 
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The kernel will turn off scalar cache for processes that are part of a multi- 
tasking group. When the kernel sees that the program is multitasked, scalar 
cache will be disabled from that point on to toe end of program execution. 
Scalar cache cannot be automatically re-enabled when a program reaches the 
end of a multitasking region unless ±e associated tasks explicitly exit. 

A way to ensure that your program is executed entirely with scalar cache is 
by setting the environment variable NPCUS=1 before calling the program to 
execute. For example: 

# NCPUS=1; export NCPUS 

# 7a.out 

It may be that certain programs executed with cache enabled do not see a 
benefit in terms of decreased run time. This may be due to the piece of the 
program executing a multitasked library routine that turns off scalar cache 
until completion of the program. To verify that a program will benefit from 
scalar cache, perform the following steps: 

Step 1. Make sure you are on a CRAY J90 running J90 UNICOS 
8.0.4B or later. 

Step 2. Run the program without recompiling on a J90 UNICOS 8.0.4B 
or later system. This ensures that code will not have the scalar cache bit 
set in the exchange package and will not enable scalar cache for the pro- 
cess. Use the timex command to measure the real, usr, and system 
times by executing: 

# timex 7a.out 

Step 3. Recompile and relink the program on a J90 UNICOS 8.0.4B or 
later system with CRAY-J90 as the TARGET. If the program cannot be 
recompiled then run the scanit(l) command against the program 
executable. This will ensure that the code is enabled for scalar cache 
execution. 

Step 4. Run the program again using the timex command to measure 
the real, usr, and system times by executing: 

# timex Ja.out 

Step 5. Compare the times received from step 2 agains step 4. If the 
times from step 4 didn’t decrease then it may be that the program has 
executed a multitasked operation. When a multitasked operation is 
encountered the UNICOS kernel will automatically disable scalar cache 
for the duration of the process. To check if the program has performed 
a multitasked operation execute the following: 

# NCPUS=1; export NCPUS 

# timex 7a.out. 

Step 6. Compare the times received from the timex command in step 5 
against the times in step 4. 
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If Ehe times of step 5 decreased then the program does have a muM- 

tasked operation in it but would benefit more with scalar cache. In this 
case restrict the program to be executed in scalar mode by setting 
NCPUS to 1 before executing the program. 

If the times received from step 5 are larger than step 4 then the program 
has enough multitasked operations so that it benefits more from a multi- 
tasked envirO'nment. Continue to run code as normal. 


J90 install and jconflg 

» Scalar cache is. disabled by default m J90 UNICOS 8.0..3.2J and 8.0.3.2K. 
Any time the J90 Mainframe Hardware Setup in the J90 Install Utility 
is run, scalar cache will be disabled. Any time the jconfig command is run, 
scalar cache will be disabled unless the scalar cache option is specifically 

enabled. 

• Scalar cache is enabled by default in J90 UI4ICOS 8.0.4B or later. Any 
time the J90 Mainframe Hardware Setup in the 190 Install UtiliPy is ran, 
scalar cache will be enabled. Any time the jconfig command is run, scalar 

cache will be snabled. unless &e scalar cache op-hcn is specifically disabled. 

* The jconfig command reads the existing .cfg files and uses these parameters 
as the system defaults. 


Offline Diagnostic Ran Manaally 

The MIowi.ng list of diagnostics use msmor/ as. an nter-prccessoT commu* 

nicatioa port and will fail when ran manually if cache is enabled. Therefore, 

the 'd. cf tian (disable scaliar cache) Eiiost be used in conj-anctloc with tfee 
offiirie(Sj eommand, to disable scalar cache during execution fi e\ ‘offline -d 
testjiaine”) 


Jsenc, jbsr, jbrt, jalit, jpctc, jsdt, jjpt, jgjt. Jptnt. jdil, jiot 

TroubiesliO'Otir'g tip: If using the offilne co-mmaad with cache 
art, offlice diagEOStic tinies-c’ttt, it is rscomixierjdsd tli,e .diagrj,ostii 


enabled, and 
be rarj witli 


scalar cache disabled. This will help to- distinguish bePween the possibility of 
a CPU verses a memory board problem, due to the fact that if it doesn’t time- 
out with cache disabled and that cache resides on a processor module, one 
can determine the processor module as the probable (FRU) field replaceable 
unit at fault. 
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6.2 Significant Open Problems 

6.2. 1 Tape Device Access Check 

Since J90 UNICOS 8.0.4B, the DDAL device driver prevents concurrent access 
with the Tape Daemon resulting in a significant impact to any J90 Utility requir- 
ing access the tape device when UNICOS is running. These procedures include 
Software Upgrade, Backup, and Restore. Before running these procedures, log in 
as root at the UNICOS console and follow the steps below to ensure appropriate 
access to the tape device: 

Step 1. Enter the following command: 

#mt -f /dev/tape/rpd03 rewind 

If no errors were reported, access to the tape device is ok. 


Step 2. If you received an error indicating "No such file or directory", it indi- 
cates you are not using the Tape Daemon. Next, enter the following com- 
mand: 

# mt -f /dev/nrpd03 rewind 

If no errors were reported, access to the tape device is ok. If other 
errors were reported, you need to manually re-create the character spe- 
cial devices, then go back to step 2. 


Step 3. If you received an error indicating "Tape open rejected due to device 
configuration", you first need to configure the device down: 

# tpconiig rpd03 down 

If you received an error indicating "Tape Daemon not available", enter 
the following commands to start the tpdaemon and configure the tape 
unit up and down: 

# /usr/lib/tp/tpdaemon >cr 

# tpconfig rpd03 up 

# tpconfig rpd03 down 


Step 4. Enter the following command: 

# mt -f /dev/tape/rpd03 rew 

If no errors were reported, access to the tape device is ok. If other 
errors were reported, you need to fix the Tape Daemon errors and go 
back to step 3. 

For more information on tapes, refer the Basic Administration Guide for the CRAY 
J90 and CRAY EL Series, publication SG-2416. 
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6.2,2 Flies created on the SPARCstation’s /opt*'ios/xxxx filesystem by non-crayadm 
accounts without proper permissions can cause problems with cenairi lOS-V com- 
mands. Files without either group read permission for crayadm or global read 
permission for crayadm cannot be read by the crayadm account, and thus by the 
lOS. Some lOS-V commands may not check the status of the openO system call 
correctly and, therefore, will not print a ’’Permission Denied” message when 
encountering this error. In these cases (such as the iu command) the command 
will exit widiout printing the proper error message and thus give the impression 
that the system is hung. If you encounter such a condition, first check to ensure 
all files are owned by crayadm and have the correct permissions set. 


6.2.3 The pddconf(8) command, which is used to control the state of disk drives, 

requires device nodes in the directory /dev/ddd. Each disk device in the system 
can have one entry. Sites that use the pddconf command will need to ensure that 
these devices are created. Otherwise, they are not necessary. 

A script is provided with each J90 UNICOS 9.0 release to create /dev/ddd 
devices. Following any UNICOS installation or any alterations to the "disk" 

entries tn the LWICOS configuration file (/etc/config/param). the following steps 
shculd be; esecuted as root on, the UNICOS system: 

# /bin/rni -f /dev/ddd/* 

# /Mmexdf -I Instalhescripts I 

# /scripts/dddereate 

The ^Tcrip’tS'/ddidcreate script uses the /stc/config’pMam. file by defaait. Ano-tlier 
oonfig-aradcrT" rile can ie specified with the -f optic®. For example: 

#' /scripts/dddcreate ••f paramfileii.aoi€ 


The tape configurate n fils does o.ot recognh 
In /ecc'cmr u/iapcu(jafi.g, the followi. 
be s.ped£&d ©n ''.+'^0" and '''3^90E'", 

ify ”3480” Of "47810 

The associated SPR is 93635, 


i& certMn, valid devices that ;8je sup- 
,ng DEVICE sta.tement tyf«s rt 2 > cot 
To werk arouad tbjs prololenc, ,5pec- 


6.2.5 For machines that have snon-sequentiaily numbered epus, the cpu-device nodes 
need to be manuaiiy recreated via the MAKE. DEV script. This procedure should 
be nin before entering multi-user mode after an initial or upgr,ade installation. 
The epu argument to the /dev/MAKE.DEV script needs to specify the nighest- 
numbered epu, rather than the actual !3,umber of epus in the system. For exsmpie,, 
if the system has, four epus and the epu numbers are 0. 1, 2, and 5, you should use 
5 (five) as an argument to the /dev;MAKE.DEV script rather than 4 .j'our), ?e,g. 
MAKE.DEV epu 5). 

Please note the install tool (ICMS) will optionally create the cpu-device nodes if 
you activate the kernel configuration. If you have a machine with non- 
sequentiaily numbered epus, it is recommended that you manually run 
MAKE.DEV later to properly create the /dev/cpu nodes. 
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6.2.6 Exabyte Variable Blocking 

There is a variable blocking problem with Exabyte tapes that affect CRAY J90 
character special devices (via /dev/device) and lOS access to all forms of Exabyte 
drives. This problem does NOT affect access via the tape daemon or tape daemon 
character special devices (/dev/tape/device). 

The associated SPRS are; 

82392 - TAPES WRITTEN WITH TAPE SUB-SYS. COMMANDS CAN’T BE READ BY ELS DEVICES 
891 19 - lOS PANIC AFTER UNICOS GAVE SET_F!XED: SLEEP ON CTLR 0 SID 2 Llun 0: TiMEOU X 

• The Problem 

Prior to the J90 UNICOS 8.0.4 release, Exabyte tapes (rseXXX) written via 
the lOS or the /dev/device for character special access, ( referenced as 
"DDAL"), used a fixed block length of 2048 bytes. This implies each block 
was broken into 2K chunks when written to the tape. But Exabyte tapes 
written via the tape daemon or tape daemon character special 
(/dev/tape/device) used variable blocking. This created the incompatibility 
referenced in SPR 82392. The design/implementation which switched back 
and forth between fixed and variable block length modes caused the panic 
referenced in SPR 89119. 

• The Solution 

Starting with the 190 UNICOS 8.0.4B release, all SCSI tape devices shall use 
variable blocking for all forms of access; lOS, DDAL, Tape Daemon, and 
Ta{^ Daemon Character Special (with the notable exception of QIC devices 
which have always used a 512 byte fixed length block size for all forms of 
access). Please be aware that the DDAL interface breaks requests down into 
32K bytes maximum. So a block greater than 32K will become multiple 
blocks on the tape. Additionally, the DDAL interface can only read tapes 
written with blocks 32K or smaller (Previously this limit was 2K or smaller). 

• Customer Impact (previously written Exabyte tapes) 

Any Exabyte tape that was written previously via DDAL or the lOS will still 
be readable as long as the input program reads until EOF (such as the cp or 
dd commands) rather than aborting when the number of bytes read is less 
than requested. 

For applications such as the tar command, where the size of the first block is 
important, a call to the dd command is required. This dd command should 
specify an input block size of 2048 and output block size equivalent to how 
the tape was originally intended to be written. 

• Customer Impact (newly generated Exabyte tapes) 

Any Exabyte tapes created on J90 UNICOS 8.0.4B or later via DDAL or the 
lOS will not be readable via DDAL or the lOS on releases previous to J90 
UNICOS 8.0.4B or on a CRAY YMP/EL. 

• Migration Period (DDAL to Tape Daemon Character Special) 

Until UNICOS 9.2, there will be two lOS ioctl’s available via the mt com- 
mand (setblklen, getblklen) to set and retrieve block length. These com- 
mands are not recommended for normal operations, but can be used when 
required (assuming only DDAL access is necessary). 
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6.2.7 Interphase ATM Devices 

If you have Interphase ATM cards,, in the lOS /config file, you will need to replace 
the /dev/atrai driver with the /dev/atmv driver. 

6.2.8 Message Catalogs 


The message catalogs are not available in single-user mode in J9C UNICOS 9,.0^. 

If you need access to them, you must first mount the /usr file system. 

6.2.9 The following diagnosric problems are noted below: 

The J9Qi boundary’ scan test <^bs) uses a configuration file to determine what 
modules are present in the system and the boundary scan revision for each 
module. Please note the configuration file is not present the first time the test 
is. executed after software installatioE. If this configuration file is not present,, 
or has been corrupted, the test displays the following message: 

JB.S ERH.OR " syscfg.c (407 J 

Unable to open configuration file for read. 

Files / sy s / c on f ig , j bs 

beard configurate on settings mil be used and 
saved* Run jbs with “-.menu“ option to reconfigure 
beards to be tested, 

.-After displaying this message, the jbs test gensrstes a new conSguratiori file 
ax-d tests the h.ardwsrs according to this s:ev/ ccnfigurati'CEi. 

Tfesre is tKO way for the jbs appltca-tion to d.etgrmirie the re'"isioa of the meni- 
ory and processor nodules ia the system, sc this initial eonfiguratioE file will 
defaulit all modules to revision .A. The user mus: verify that this is ccsrect for 
their system, TMs cm bs done by verifying the iafermation displayed tO' the 
us-er when the jbs applicatioE is run... For example, w‘heo Jbs is rac, the fol- 
.low.ing infc>nna.tic'n whl be displayed ; 

JB.S Cenf igurat Isn s f.y§!t€r,-bplA,B' 

Tlt€ following boa.rds ara aelseted. for test i 
P RO'C C r *3 V A 
PROCL rsv A 
F’P.OC'2 rev A 

Every .190' module contains a label with the boundary scan revision (BSN=A 
or BSN=B). Verify that this label matches the information displayed. If the 
modules revisions are not correct, update them by ruiming ’jbs -menu’. 


If the system is powered down, and a module with, a different revision is 
added to the system, Jbs will fail when ran from frstload due to the fact that 

the module revision number will be mcorrect in die jbs configuration file.s. 
The user will need to run jbs with the -menu option lo reconfigure me board 
revisions. 

If the user is going to add a module with a new revision to the sysiern, then 
they should run ’jbs -menu’ and reconfigure before powering down the sys- 
tem. After reconfiguring, the user can exit jbs, power down the machine and 

swap modules. After swapping modules, frstload should pass because the 
new configuration is already saved. 
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6.2.10 Load Binaries on 8032J or 8032K Upgrades 

If you are performing an upgrade from J90 UNICOS 8.0.3.2 J or 8.0.3.2K, run- 
ning the Load Binaries step in the Upgrade Installation window will cause the 
lOS to reset to the BOOT prom causing a running UNICOS system to crash. To 
avoid this problem, follow these procedures to manually load the install binaries 
instead of running the Load Binaries button on the Upgrade Installation window: 


• Exit the J90 Install Utility 


• Insert the J90 UNICOS 9.0.2 release tape 

• Open an xterm window by holding the right button in the Open Windows 
root window and log into the J90 Console. 

# rlogin snxxx-iosO (replace xxx with your J90 serial number) 

• Load in the opt . tar image from tape 


snxxx-ios0> 

snxxx-ios0> 

snxxx-ios0> 

snxxx-ios0> 


cd/ 

mt -f rpd03 rewind 
mt «f nrpd03 fsf 1 
tar -xvf nrpd03 


• Release the console 


snxxxx-iosO> 

• Login as root on a SPARCstation Open Windows window 

% su 

• Load in the opt.tar file from disk 

# cd/ 

# tar -xvf /opt/ios/xxxx/opt.tar 

# rm /opt/ios/xxxx/opttar 

# exit 

• Invoke the J90 Install Utility via the Open Windows root menu 

• If you wish to run with scalar cache On, you must run the Mainframe Hard- 
ware Setup procedure in the Initial Software Installation menu. This will 
rebuild the hardware configuration files that turn on scalar cache by default. 

• Exit the Initial Software Installation window and re-enter the Software 
Upgrade window. 

Upon completing this step, proceed to the Upgrade Installation subsection. 
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6.3 Problems with Related Products 

6.3.1 Installation/Configuration Menu System (ICMS) 

* When selecting the media t 3 i^s for loading asynchronous products in the 
Define Load Device menu, choose the value J90_EL. 

UNICOS 9.0 Instalation / Configuration Menu System 
Release Media Management ==> 

Define Load Device 
Media Type J9C_EL 

Set the Remote Cartridge (J90_EL) device name selection item lo be 
/dev/tape%pd03 (or the name selected in the tape daemon configuration file), to 

use the tape daemon character special device. 

* If you wish to ran the InstallatiomCcnfiguration Menu System (ICMS), but 
have never run it before at your site, you must first import all parameters by 
invoking the following ICMS menus as follows: 

Utilities -s=> 

Import utility ==> 

Import class to run ALL 
Run the import process ... 

• During Import All (Utilities Memuj, you may see the following errors 
which should be ignored:: 


~ IS5ECURITY3 Iiriporting Spiet.corif. 

spnetsli u cfdib 

Can’t JiEd 


upon returaing from the iEiport process, you may see the following errors 
whici. should be ignored:: 

inmesiu Seleclio*n vake "2"' spedfted by lag field SHMSEG lr menui utsshare 
for product ms is iinvaiDd m ibe aew seliscfioii List fO ]. 

SelectioE reset to the first value spedied in the stew selectiosi list 
which is the defaali, 

inmeoE Sejecdon value "16"' specified by i:ag field tipmaxppd m menu hidden; 
for prcduict ills is invalid in the new selec-tion list [0 ]. 

Selection reset to the first value specified in the new selecdoo 1st 
which is the default. 

inmenii Seleckcn vake ""250"' specified by tag fidd NLBf¥!.4? in rmnu hidden 
for product ots is invalid in the new selection list [I ]. 

Selection reset to the first value specified in the new seiection list 
which is ihe default. 

inmenu Selection value "250” specified by lag field NMMT in menu hidden 
for product uts is invalid in the oaw seiection list [1 ]. 

Selection reset lo the first value specified in the new selection list 
which is the default (EOF): 
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6.3.2 Applications using Cray libs. 

If applications are ported from YMP or YMP/EL series machines, they need to be 
relinked with Craylibs 1. 2.0.3 in order to avoid bidirectional memory errors on the 
J90. 


6.3.3 CRAY Reel Librarian. 


There is a problem installing Cray REEL/Librarian on CI^Y J90 systems with 
multi-level security (NILS) feature enabled. In the Cray/REELlibrarian (CRL) 
Administrator’s Guide, publication SG-2127, replace the MLS procedures in Sec- 
tion 3.8 (Rebuilding spset, spget, and spclr), with the following: 


On CRAY J90 systems with the multi-level security (MLS) feature enabled, 
perform the following commands to rebuild and reinstall spset, spget, and 
spclr: 


# cd /usr/src/cmd/sp 
#nmake spset spclr 

#cpset spset /bin/. 755 bin bin 
#cpset spclr /bin/. 755 bin bin 

# rm /bin/spget 

# In /bin/spset /bin/spget 


The associated SPR is 76173. 


Also please note, that Software Field Notice #1 104 recommends those sites that 
use CRL should upgrade to the CRL 2.0.6 version in conjunction with their UNI- 
COS 8.0.2.2 upgrade and beyond. If you do not upgrade beyond CRL 2.0.5, the 
UNICOS tape subsystem will be unable to communicate with CRL via the 
Remote Procedure Call (RPC) protocol interface and SIGABRT (signal 6) TM053 
messages will be written to the tape.msg file. 

6.3.4 STK Autoloaders 


Prior to installing Unicos 9.0, make sure that StorageTek product ACSLS level 
R5.(X) has been installed in your autoloader environment. 

The tape daemon source code for the UNICOS 9.0 release was upgraded to work 
with StorageTek ACSLS R5.(X). This StorageTek product is installed on a Sun 
platform and communicates through TCP/IP with any Cray mainframe to mount 
and dismount magnetic tapes in an STK44(X) tape silo. 

If the StorageTek product ACSLS of a level prior to R5.00 is installed with UNI- 
COS 9.0, the connection between the Cray mainframe and the Sun platform that 
controls the STK44(K) silo cannot be established, and the STK4400 autoloader is 
not usable. 


For more information, refer to Software Field Notice #1173. 
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6 J m SPMs. FIxei 

64 J SPRs closed in the J90 UNICOS 9*0.2 release filed against J90^L machines: 


ATM 


URGENT 

94521 

DF 

MINOR 

93494 

FILESYSTEMSi 

CRITICAL 

96095 

CRITICAL 

96321 

.fTA 

URGENT 

VdOU4 

HDD' 

U'RGE!^Cr 

96396 

mppi 

CRITICAL 

101031 

WSTALL 

URGEOT 

96313 

URGENT 

96943 

M.AJOR 

I0C41S 

EES“Hi 

96639 

LHC 

URGENT 

9%m 

MI5BCP 

CEITICAL 

97322 

CRITlOl, 

msm 

UIGEOT 

98964 

MAJOR 

9629Q- 

NFS 

lYAJOF. 

5'S494 

NSCHEDV 


9oCi85 

OLHPA 

CRITICAL 

9S43Q 

URGENT 

96771 

URGENT 

99885 

MAJO'R 

99159 

PUBS 

DES*«I 

I0IS93 

SaM 

MAJOR 

99623 

SCANIT 

'URGENT 

93135 

'URGE>4T 

97383 

URGENT 

973E8 

URGENT 

97468 


NFS JOBS; HANG AFTER THE, SERVER RECOVERS FROM A REBOOT 


DF INFO ON iPROC INACCURATE 


PANIC: ASSERT: FIO.C: 71:(FP-^>F^COUNT > 0) 
PHASEH FOP^MED 110 HX FOR UNICOSMAX 


FTUA GET ( IBMBLOCK MODE ) FAILING IN FFCLOSE 


PANIC : MEMUNLOCK OF UNLOCKED SEMAPHORE 


HIP'PIPROBEO BROKEN IN 9.0 


iiO'‘'S AND ELS BUILD WITH THE WRONG TARGET OR NO TARGET AT ALL 
INSTALL TOOL DOESN'T INSTALL LIBRARIES OR INCLUDE HLES 
IMPORT OF DEVICE r«^'ODES SOMETIMES YIELDS INCORRECT RESULTS 
IKCSLCVT SCRIPT ERRORS OK DDJJ DURING 8. OAT INSTALL 


CODE Cx'3V1NG INCORRECT RESULT'S 


MDDCP IS VERY SLOW BOT' CAN BE IMP'RO^v^ED 

MDDC? TAKES ABOUT 16 HOURS TO COPY' ONE DD6S DISK TO AMCTHER. 
MDDCPC8) COMMAND IS EXTRAORDINARILY SLOTf 
UNACCEPmS.LE FERFORMANCE OF MDDCP CGMMAM'D 


SFIGID DOES 


KOI WORE ON NFS HLE SYSTEMS^ 


NSCHEDVDAY SCRIPT CONTAINS DUPLICATE LINE 


OLHM DOES NOT' REPORT CORRECT BANK ON 190 SYSTEMS 
OLHPA output NOT’ HELPFUL FOR J90 TAPE PROBLEMS 
OLHPA DOESNT PROViDE USEFUL INFORMATION ON' SOME TAPE ERRORS 
TAPE DRIVE BEING REPORETED INCORRECTLY BY OLHPA ON J9GS 


PLEASE ADD EL AND J90 DISK SPECS TO DISKSPECC7) MAN PAGE 

CSAM COREDUMPS ON J932 WHEN RUNNING ON SCREEN WITH 52 OR 
MORE LIKES 


SEGLDR LDO'PS WHEN TARGET IS CR.AYG90. 

GET LDR-351 THIS PROGR.AM IS NOT CACHE-^SAFB- WHEN uNKINC 
CRAY-J90 APPLICATION 

JT4 JUMPTRACE: WARNING ERROR OCCURS WHEN USING F90 AND CF77 

MASSAGER GENERATING BAD CODE 
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SEGLDR 

DES-HI 100890 

DES-MED 100636 


SENDMAIL 

URGENT 100982 

SFS 

CRITICAL 96392 

CRITICAL 96433 

URGENT 96492 

URGENT 97477 

URGENT 97633 

MAJOR 100295 

TAPES 

CRITICAL 97094 

URGENT 96072 

URGENT 98244 

URGENT 98583 

MAJOR 99545 

MAJOR 99638 


TCP^USER^CMDS 
MINOR 87417 


UNICOS 

URGENT 99875 


RELEASE YMP VERSION OF SEGLDR AS J90 CACHE SAFE FOR BETTER 
LINK TIMES. 

ADD AN OPTION TO SEGLDR TO MAKE SCALAR CACHE PROCESSING 
OPTIONAL 


MAILQ AND NEWALIASES NOT INSTALLED CORRECTLY 


PANIC: MEMUNLOCK OF UNLOCKED SEMAPHORE 
PANIC: ASSERT: SMP4PI3.C: 129;((Q >SQ„FLAGS 
& SMPCLSTARTED)... 

PANIC: ASSERT: SFSIGET.C: 159:((NC1IP->NC1LSFSMLS = 1) 
H-SMP DEVICE CAN SEND RESPONSES BACK TO WRONG IHELD 
ASSERT: SMP4PI3.C: 179:(Q->SQ^FLAGS & SMPQ^QUEUED) 

SFS SEMAPHORE COMMANDS FAIL DUE TO TIMING WINDOW 


TAPE DAEMON DIES WITH ORE EVERY DAY OR TWO 
STILL : LDR VOLSERV DOWNED: (079) - DRIVE IN USE 
TAPE DAEMON PASSES BAD INFORMATION TO USER EXITS 
TAPE READS AND WRITES HANGS JUST A,FTER TAPE MOUNT 
I^^^ER]V^rITENTLY 

TAPE GETS LOST IN SILO TAPE DRIVE WHEN DRIVE IS DOWNED 
TPMNT FAILS WITH "INVALID DEVICE NAME' IF TPMNT ISSUED 
BEFORE DRIVE IS IDLE 


RCP RETURNS AN UNHELPFUL ERROR MESSAGE WHEN FILE 
SYSTEM IS FULL 


NO LOGIN POSSIBLE (UNICOS STILL RUNNING) 
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6.5 J90 Software Field Notices Fixed 

The following fixed FNs were filed against J90/EL machines. 

J9C UNICOS 9,0„2 

1 173 ACSLS R5100 needed for the UMCOS 9Xi software 

2025a Users can become root by esing the tape command tplist 

2047 olhpa error reporfng problem 

2058 Multitasking accounliog incomplete when NCPU greater than 24 

2085 Improper Handling of User Uncomectable Memory^ Errors 

2118b Problems accessing DAT drive from lOS 

2122b' ' Potemtiall Data Corruption Using UNICOS lape Daemon 
2125 Security Hole In KSMI 

2i26a Tape Data Cormption when Upgrading CRAY 190 Series lO'S 

2127a New fixes and peifomi.aii.ce improvements for SEGLDR/’SCiANIT 

2137 Faulty crash(g) binary for J90 at UM'COS 8.0.4.2 

2138 Misskg X Window Syslem libraries for J90 at UNICOS 
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